Skip to main content

How to connect to the Integrations Config Bucket using WinSCP

How to connect to the Integrations Config Bucket using WinSCP

Prerequisites:

  • Have WinSCP installed on your computer

Steps:

  1. Obtain Credentials: To gain access to the GCP bucket of the cloud project, you need the credentials of a service account. This can be requested through the Service Desk. Select 'Service Request' / ' ‘Request a new account’ and give the following information:

    • the project id
    • role (upload)
    • environment indicator (e.g. production or staging)

    Additionally, state the purpose of the service account ( = to be able to upload configurations for the integrations component), and provide the link to this documentation page to indicate your purpose.

    Your service account will be formatted as follows (example): {project-id}-upload-{env indicator}-sa. If you are unsure what information to give - don't hesitate to contact your project support.

    Once you've obtained the credential file, you can extract the Access Key ID and Secret Access Key.

  2. Open WinSCP:

    1. Launch the WinSCP application.
  3. Create New Site:

    1. In the login dialog, select the "New site" option.
    2. Choose S3 as the file protocol.
    3. Enter storage.googleapis.com in the "Host name" field.
    4. Enter the Access Key ID and Secret Access Key obtained in step 1.
  4. Advanced Settings (Directory):

    1. Click on the "Advanced" button.
    2. Navigate to the "Directory" section.
    3. In the "Remote directory" field, enter: {project id}-integration-service
  5. Save and Connect:

    1. Click the "Save" button to save the site settings.
    2. Click the "Login" button to establish a connection to the config bucket.

Uploading a file is then just a matter of dragging your JSON file into the destination folder.